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Champ is designed to run on the Commodore 
64, BBC Micro model B, and Sinclair 
Spectrum 48K. 

It comprises an assembler for 6502/6510 or 


Z80 Assembly language, aprogrameditor,and <EDIT> mode relay Sii a 
a monitor/debugger/disassembler. These enables you to modify an existing Assembly 
facilities make Champ a powerful aid to the language program KEY MEANING 
Assembly language programmer <DEBUG> mode [RET] [Return key]: 
allows the inspection or modification of the [Enter] on 
LOADI NG CHAMP contents of the memory, or the execution of a Spectrum 
BBC Model B — CHAIN “” ele be coe pga [ESC] [Escape key} 
: < 
C64 — Hold down [SHIFT] and hit Both <ASSEMBLE> and <DEBUG> modes are oa 
[RUN ISTO P] command modes. In these modes various keys 4] on 
represent commands which make something happen Spectrum 
Sp ectrum 48K — LOAD “” to your program or to memory. On the other hand, [CRSRR] [Cursor Right]; 
<INSERT> and <EDIT> are text modes; with these [Caps Shift + 
Champ will auto-run when loading is complete, so, you can move program text around on the screen, and 8] on Spectrum 
having issued the LOAD command, you need do add to, or modify, it. [CRSRL] [Cursor Left]; 
nothing until the screen clears and displays the You can change from one mode to another as shown [Caps Shift + 
copyright message. Stop the tape, remove it, and here: 5] on Spectrum 
replace it with a blank data tape if you intend to save anai 
program files frorn Champ. ae < [RET <INSERT> [N pa 
in addition to the copyright message on the screen, [ESC] 7| on Spectrum 
you will see a message about Champ’s location in vn: 
memory; this is important data, so make a note of it all <ASSEMBLE> NI map 
now, even if you’re not sure what it’s for. When you've [M] [A] 6] on Spectrum 
done that, hit [ESC] to run Champ. {CTRL [Control Key]: 
The screen should look like this: <DEBUG> [Caps Shift} on 
ee If you have just loaded Champ, then there is no Spectrum 


Field Field Field 


Error Line | 





language program, in order to assemble it into 
machine code 

<INSERT> mode 
is what you use to type in an Assembly 
language program 





Assembly language program in memory, so 
<ASSEMBLE> mode cannot yet be used. Switch 
modes to <EDIT>, and thence to <INSERT>. You 
will see the prompt on the Command Line, and a 
blinking Cursor on the Edit Line. 

Suppose that you wish to enter the following 
program: 


DATA1 EQU $23 
STORE1 DB $00 
STORE2 DB $00 
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KEY CONVENTIONS 


A letter (or letters) enclosed in 
square brackets, thus, [A], means 
‘the key carrying this symbof. 












































[SP] [Space Bar] 





LDA #DATAIL LD A, DATAL 
Command Line] <ASSEMBLE> ADC WDATAL ADC ADATAI 
STA STORE1 LD (STORE1),A 
As you can see from the prompt on the Command Line, ADC #DATAI ADC A,DATAL 
this is the <ASSEMBLE> mode; other modes are STA STORE2 LD =(STORE2),A 
<EDIT>, <INSERT>, and <DEBUG>. The screen sso °S a 


display in <INSERT> and <EDIT> modes is similar 
to that of <ASSEMBLE>, but the <DEBUG> 
screen is a different colour, and shows only the 
<DEBUG> prompt. 

You use these modes for the following purposes: 


<ASSEMBLE> mode 
is used after you have typed in an Assembly 


Type it in exactly as you see it; you will discover that 
Champ has automatic syntax and format checking. 
This means that you cannot exit from a line that 
contains a syntax error, or does not conform in layout 
with the three-field format of the screen. You will find 
that [CRSRL] and [CRSRR] move the cursor back and 
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in <ED!IT> mode, source text is 
displayed with the cursor on the 
Edit Line, and <EDIT> on the 
Command Line. Text on the Edit 
Line can be overwritten or deleted 
(using [DEL] or [SP]). [RET] 
causes the Edit Line contents to 
be checked for syntax and format. 
An error message will appear if 
the line is faulty, and the text will 
remain on the Edit Line. If the line 
is acceptable, it will be entered 
into the source text, and mode 
will change from <EDIT> to 
<INSERT>. [RET] toggles these 
two modes, while [ESC] toggles 
<EDIT> and <ASSEMBLE> 
modes. 

The following keys can be 
used to move the source text on 
the screen, assuming the text on 
the Edit Line is correct. If a line is 
edited, and if the edited text is 
valid, then any of the following 
keys has the effect of entering the 
new line into the source text 
without changing the mode. 


Itis in this mode that you actually 
type your Assembly language 
program into the Assembler. The 
Command Line shows 
<iINSERT>, and a flashing 
cursor appears on the Edit Line. 
The Edit Line (and the whole 
screen) is divided into three 
coloured columns, corresponding 
to the Label, Instruction, and 
Operand Fields of an Assembly 
language program: 


Label Field 

A label is any alphanumeric 
string of up to six characters. 
There must be a letter in the first 
position of the Field. A label does 
not require a colon (or any other 
character) as delimiter. 


Instruction Field 

Instructions are Assembly 
language mnemonics as in MOS 
Tech 6502 and Zilog Z80 
specifications. They may be two, 
three, or four letters long, starting 
in the first position of the Field. 


Operand Field 
Operands may be hex constants 


| (which must be preceded by $), 
labels, symbols, or expressions 


comprising 


` octal, anc binary constants are 





two operands 
Separated by + or —. Decimal, 


<EDIT> MODE 
COMMANDS 


<INSERT> MODE 
COMMANDS 


KEY 
[T] 


[4] 
[CTRL}+[U] 


EFFECT 

Moves one line up 
the text. 

Moves one line 
down the text. 
Moves the screen 
text up one page. 
Moves the screen 
text down one 
page. 

Moves to the top 
of source text. 
Moves to the 
bottom of source 
text. 

Deletes the Edit 
Line contents. 
Enters 
<ASSEMBLE> 
mode. 

Enters 
<INSERT> 
mode. 


[CTRL}+[D} 





[CTRL]+[T] 





[CTRL]+[B} 


[CTRL]+[Z] 
[ESC] 


[RET] 


1 


N.B. The text movement keys 
have the same effects when used 
in <ASSEMBLE> mode, but 
they then do not require [CTRL] to 
be pressed. Thus [U] in 
<ASSEMBLE> mode moves 
the screen text up one page. 










































not permitted. Operand formats 
for the various addressing modes 
are as specified by MOS Tech 
and Zilog. 


Text entry in <INSERT> is 
subject to Field Formatting: This 
means it is impossible for you to 
type a seven-character label, or a 
five-character instruction. Typing 
an extra character, or hitting 
[SPACE], causes the cursor to 
skip to the first position of the 
next Field. 

The [CRSRR], [CRSRL], and 
[DEL] keys act as normal in 
<INSERT> mode — subject to 
Field Formatting — but the 
delete key acts on the cursor 
character rather than on the 
character to the left of the 
cursor. 

When you hit [RET] in 
<INSERT> mode, the contents 
of the Edit Line are checked for 
syntax and format; if an error is 
found, then a message appears 
on the Error Line. If no error IS 
found, then the contents of the 
Edit Line enter the source text, 
and the Edit Line is cleared for the 
entry of a new line. Hitting [RET] 
when the Edit Line is blank 
toggles between <EDIT> mode 
and <INSERT> mode. 






| @ addr 


<DEBUG> MODE 


This mode combines the following 
functions: 

Memory Monitor — allows you to 
inspect and alter the contents of 
memory. 

Hex Disassembler — allows you to 
interpret the contents of memory 
as machine code to be converted 
back into Assembly language. 
Debugger — allows you to execute 
machine code programs in an 
error-trapping environment. 


<DEBUG> is a command mode, 
but the Command Line/Edit Line/ 
Field Format display of the other 
modes is not used: the screen is a 
blank page showing only the 
prompt and a cursor. In this mode 
all constants are hex constants 
without the ‘$' prefix, although 
the ‘H’ command supports 
decimal constants. 


COMMAND EFFECT 


COMMANDS 


ABBREVIATIONS 


addr 
saddr 


faddr 


daddr 
hx 
regname 


expr 


bystr 


chstr 


any hex address 

Start address of a 
block of memory 
finish address of a 
block of memory 
(=1+ address of last 
byte of block) 
destination address in 
hex 

a hex value (hx<= 
FF) 

CPU register name 
(see below) 

any arithmetic 
expression in one or 
two operands; 
operands may be 
decimal constants, ‘$’ 
— prefixed hex 
constants, or legal 
symbols; operators 
are ‘+’ orm 

a String of hex byte 
values separated by 
spaces 

a string of characters 
(exactly as it appears, 
no separators) 


Memory from the given address onwards is displayed 


one byte at a time, in hex and ASCI! equivalent. Hit 
[RET] to advance to next byte, hit [ESC] to return to 
command level, or type a hex constant to replace the 
existing content of the byte 
A Return to <ASSEMBLE> mode 


D addr 


Memory from the given address onwards is displayed in 


Screen pages; hit any key to continue, or [ESC] to 
return to command level 


BASIC panel 


F saddr Every byte between saddr and faddr is filled with hx 

faddr hx 

M daddr The block of memory between saddr and faddr is 

saddrfaddr copied to the block starting at daddr 

| Qaddr Memory from addr onwards is disassembled; hit [RET] 
to continue, and [ESC] to return to command level 

G addr The code starting at addr is executed (returnable) 

C addr Execute from addr (non-returnable) 

Bn=addr A breakpoint number n, (between!1\ and 8) is set at 
addr, to cause a break in execution of any program 
which accesses the contents of addr as an instruction; 
press [C] [RET] to continue from breakpoint 

En Eliminates breakpoint n 

T Displays the addresses of all the breakpoints 

R regname Displays the contents of a CPU register and accepts a 
new value (similar to the function of ‘@’ above) 

J addr Executes the code from addr onwards, one instruction 
at a time, giving a full register display. Hit [J] to 
continue, [ESC] to return to the command level 

H expr Displays the decimal, hex, and binary value of expr 

S bystr Searches the memory from $0000 onwards for every 
occurrence of bystr. The word ‘searching’ is displayed 
while the program is searching, and the address Is 
displayed when bystr is found. Hit [RET] to continue 
the search, or [ESC] to return to command level 

Nchstr As‘S' above 

W Load, Save, and Verify machine code to tape; see 





CPU Regis 
Abbrev 





6502 


A = Accumulator: X, Y = X, Y 
registers; P= Status register; SP 
= Stack Pointer 





| <ASSEMBLE 


COMMAND 
FORMATS 


Find => string [RET] 
Searches the Assembly language 
program from the start of the 
program for the first occurrence 
of the given string. 
Next => string [RET] 
Searches the Assembly language 
program for the next occurrence 
| of the given string. The search 
begins from the end of the 
program line currently on the Edit 
Line. 
| Find =>[RET] and 
| Next => [RET] 
As above, but this searches. for 
the string defined in last ‘F or ‘N’ 
command. While a search is 
preceeding, the message 
‘searching appears on the Error 
Line. If the search is successful, 
the line containing the string 
being searched for appears on 
the Edit Line If the search is 
unsuccessful, the last line of the 
program appears on the Edit Line. 
Load => Save => Verify => 
These must all be followed by a 
filename; double quotes are not 
needed, but the filename must be 
legal for the user's machine. 
Print => expression [RET] 
This prints the-hex value of the 
given expression on the Error 
Line. eg. 
Print —>$F8-$C1 $37 
Symbols already defined in 
source text can be used in 
expressions; but only one, 
Operator (+ or —) is allowed per 
expression. 
Quit =>[Y] 
This quits Chasm, and returns 
control to the BASIC system only 
if [Y} follows the prompt: 
any other response aborts the 
command. 
[M] 
Enter <DEBUG> mode. Return 
| from there to <ASSEMBLE> 


scene AE A S EESE S EEEE ESEESE SEEE EE E EE 


a 


| mode by pressing [A] [RET]. 
| [ESC] 
Toggle <EDIT> and 


<ASSEMBLE> modes. 

Assemble => (option number) [RET] 
This assembles the source text in 
' one of a variety of ways, 


| depending upon which numerica! 
| option is chosen: 





ter Name 
ations 


280 
A = Accumulator, F = Flag/ 
Status register, H,L,B,C,D,E = 
H... E registers; SP = Stack 
Pointer; 1X, IY = |X, IY registers. 
a ee ee 


meme se a 


> MODE 
COMMANDS 





KEY PROMPT FUNCTION 
[F] Find=> Find a string 
[N] Next=> Finda string 
[L] Load=> Load a source 
file 
[W] Save => Savea 
source file 
IV] Verify => Verify a 
source file 
[P] Print => Print value of 
| expression 
(Q) Quit=> Quit to BASIC 
[M] Enter i 
<DEBUG> | 
mode 
[ESC] Enter 
<EDIT> 
mode 
[A] Assemble Assemble i 
=> program 


To abort any of these commands, 
do not enter a command operand, 
just hit [RET] in response to the 
prompt. 


Spectrum variations | 
KEY PROMPT 
ÍJ] Load => 
[S] Save =>; 





isymshift] + Verify => 
[R] 


Display full 
Load m/code 


Copy screen 


eV 









OPTION NUMBER 
01234567 


liston screen NY NY NY NY 


into memory NNYYNNYY 





6502 


| INSTRUCTION ADDRESSING MODE INSTRUCTION ADDRESSING MODE 
| LDA #$D4 Immediate LD A,B Register (Direct) 
LDA $3C Zero Page (Direct) LD A,$9F Immediate 
LDA $A290 Absolute (Direct) LD ($ED46),A Absolute (Direct) 
LDA $31 FE,X Absolute Indexed LD A (HL) Register (Indirect) 
LDA $7B,X Zero Page Indexed LD A(IY+d) Indexed (Indirect) 
LDA ($2A.X) Pre-Indexed (Indirect) CCF Implied 
LDA ($2 A).Y Post-indexed (Indirect) 


CLC Implied 





INSTRUCTION 


FORMATS 


ASSEMBLY LANGUAGE 


FORMATS 
PSEUDO- 
CODES MEANING 


addr 
const 


ORG 
addr 


origin: assemble 
machine code in 
memory from addr 
onwards. The program 
line with ORG on it 
cannot take a label. 
equate: set the symbo! 
in the Label Field equal 
to the constant, 
symbol, or expression 
in the Operand Field. 
DB define byte(s): load 
const/ this location, and as 
chstr many following as 
required, with the 
value(s) of const or 
chrstr 
DW define word: load this 


EQU 


O nemme a e e 


chstr 


a_n 


symb 





const/ location with the lo- 

symb byte, and the next 
location with the hi- 
byte of the operand 

DS define storage: add the 

const/ value of the operand to 

symb the !ocation address of 


this instruction 


ASSEMBLY 
OPTIONS 


E.g. Assemble =>2 


Abbreviations: 


a $-prefixed hex address 
a $-prefixed hex 
constant; as an operand 
of DB, const must be a 
Single-byte value. A 
string of constants, such 
as (DB const [SP] const 
[SP] const... etc) is 
valid 

a string of characters 
enclosed in single quotes 
(e.g. ‘AB3%9K10’) 

any valid symbolic 
operand 


[RET] 


assembled with error-checking, 


and theresulting machine codeto 


be loaded into memory as directed 


by the ORG pseudo-op-code. The 
symbol table is displayed on the 


screen, but no assembly listing 


f 
causes the source text to be 
i 
f 
| 


toprinter =NNNNYY YY appears on the screen, and there | 
Verify labels, is no output to the printer. 
symbols & Any option number can be 
syntax YYYYYYYY preceded by 1, which gives a 
Display double-line display if the screen 

. symbol table list facility is enabled. 

| onscreen YYYYYYYY lf an error is found during 


| 
| 


| N= This facility disabled 


" | instruction appearing on the Edit 
| Line. l 


assembly, a message will appear 
on the Error Line, assembly will 
cease, and the screen will display 
the source text with the faulty 


Y = This facility enabled 
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LINKING MACHINE 


CODE AND BASIC 





Once you're familiar with both 
Champ and Assembly language 
programming, you'll probably 
want to be able to call special- 
purpose machine-code routines 
from BASIC programs, rather than 
write entire programs in machine 
code. The easiest way of doing 
this is: 
1) Using Champ, develop the 
Assembly language routine until 
it works. 
2) From<ASSEMBLE> mode, 
SAVE the Assembly language 
routine to tape for future | 
reference. 
3) Assemble the routine into 
memory, choosing an ORG 
address near the top of User RAM 
(see your computer User Manual 
for Memory Map and advice). 
4) From <DEBUG> mode, | 
SAVE the block of memory 
containing your machine code to 
tape. 
5) Quit Champ. 
6) Write your BASIC program, 
starting with the instructions 
necessary to set the Top of User 
RAM pointers to an address | 
Safely below the ORG address of 
your routine. Follow those 
instructions in the program witha 
LOAD instruction that will load | 
your machine code routine from 
tape to the location from which it 
| was SAVEd (consult your User 
Manual). 
7) Whenever you need to execute 
the machine-code routine in the 
BASIC program, usea CALL, SYS, | 
| or USR instruction with your 


I RN e o 


routine’s ORG address. 
8) Save the BASIC program as 
usual. 


If you exit from Champ to BASIC, 
| and type LIST, you should see an | 
| example of this technique at 





work: When you LOAD Champ, 
, you load only the short BASIC | 
loader program which you see; 
when this is executed, it LOADS | 
| Champ itself as a machine code | 
| file into memory, then calls itasa | 
machine code routine. 





oe 





CHAMP ERROR 


MESSAGES 





_ Error messages appear on the 





Error Line in all modes except 
<DEBUG>, which prints 
‘ERROR’ at the current cursor | 
position. 


MESSAGE 
LABEL ERROR 


MEANING 

A syntax or 
format error in 
the Label Field. 
A syntax or 
format error in 
the Instruction 
Field. 

A syntax or 
format error in 
the Operand 
Field. 

The Label or 
Symbol 
displayed on 
the Edit Line 
has not been 
assigned an 
address or a 
value. 

The relative 
jump in the 
instruction on 
the Edit Line 
requires a 
displacement of 
more than 127 
bytes forward 
or 128 bytes 
backward. 
Assembling the 
instruction on 
the Edit Line 
into memory 
would overwrite 
CHAMP itself, 
or some 
protected 
memory, or 
would be out of 
range. 

The operand of 
a <DEBUG> 
command 
contains illegal 
symbols, or is 
too large a 
quantity, or is a 
bad address, 
etc. 


INSTRUCTION 
ERROR 


OPERAND 
ERROR 


UNDEFINED 
LABEL 


JUMP OUT OF 
RANGE 


OVERFLOW 


ERROR 
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forth on the Edit Line, and that [SPACE] sometimes 
produces space characters, and sometimes causes 
the cursor to skip from one field to the next [DEL] 
erases the cursor character. Some of the effects of this 
Field-Formatted mode are strange at first, but you 
become used to them quickly. They should help you to 
produce error-free, neatly-formatted Assembly 
language programs. 

When entering a new program, remember: 

LABELS must start with a letter, and must not be more 
than six alphanumeric characters long. 
INSTRUCTION MNEMONICS must be standard6502 or 
Z80: two, three, or four letters long. 

OPERANDS must follow standard 6502 or Z80 formats. 
They can contain arithmetic expressions comprising 
symbols or hex constants and a ‘+’ or ‘—’ operator, 
and can fill, but not exceed, the entire operand field. 
COMMENTS must start on a new line with‘. They can 
fill, but not exceed, the entire line, and are not subject to 
syntax or format checking. 

When you have successfully typed in the program, 
enter <EDIT> mode. In this mode you can change the 
text on the Edit Line, and you can move the entire text 
file up and down on the screen using the following 
keys: 


KEY EFFECT 

[A] Moves the Edit Line up one line 

[N] Moves the Edit Line down one 
line 

[CTRU+[T] Moves to the top of the text 

[CTRL]+{[B] Moves to the bottom of the text 

[CTRL]+{[U] Moves text up one screen page 

(CTRL]+([D] Moves text down one screen 
page 

(CTRL]+(Z] Deletes the contents of the Edit 
Line 


These keys without [CTRL] have the same effects in 
<ASSEMBLE> mode, but you cannot delete or 
otherwise modify your text in that mode. 

Switch to<ASSEMBLE> mode now, and hit [A] in 
order to assemble your program into machine code. 
The Command Line will show the Assemble => 
prompt. When you enter ‘11’ [RET] you should see this 
double-line Assembly listing: 


0000 00 
0001 900 
0002 AS23 

LDA #DATAI 
0004 18 

CLC 
0005 6923 

ADC #DATAIL 
0007 8D0000 

STA STORE1L 
OQQA 6923 

ADC #DATAIL 
o000c 8D0100 

STA STORE2 
QOQOF 60 

RTS 
36502 
DATAL 23 


STORE1 0000 STORE2 0001 


This may be a little puzzling at first, but it shows only 
the usual parts of an Assembly list: location address 


and machine code bytes on one line; label, instruction, 
and operand on the next line. At the bottom of the list is 
the Symbol Table, which lists all the program labels 
and symbols with their hex values. 

Because you have not specified a start address in 
the program, you will see that the location addresses 
start at 0000. You must now return to < EDIT>, then 
to <INSERT> mode, and put a suitable ORG 
instruction at the start of the program. You must choose 
alocation appropriate to your machine, and for this you 
need the information about Champ’s memory usage 
given with the Champ copyright message. If you try to 
assemble code into an area which Champ protects, 
you will see the ‘OVERFLOW message on the Error 
Line during assembly. If that happens, you must 
change the ORG address. 

When you've chosen an ORG address, and 
assembled your program without any error messages, 
assemble again, but this time use the ‘2’ Assemble 
option so that the machine code is actually loaded into 
memory at its location address. Now hit [M], to switch 
to <DEBUG> mode. 

The screen should now be all one colour, showing 
only the <DEBUG> prompt and cursor. Hit [Q] and 
type the ORG address of the Assembly language 
program, followed by [RET], and you should see the 
hex disassembly of your program. If you don’t see this, 
you must check whether you have assembled it 
correctly, and whether the ORG address was correct, 
and whether it was really a RAM address. If you 
choose an ORG address in ROM, everything will seem 
towork, except that the machine code bytes will not be 
Stored at their location addresses. You may need help 
from a memory map provided in your machine manual 
to check this. 

lf the disassembly is successful, then you can hit 
[G] followed by the ORG address, which will cause 
your program to be executed. Don't worry if you make 
mistakes with this, the worst that can happen is that 
you will cause a software crash, making it necessary 
for you to reload Champ and re-type the Assembly 
language. You can insure against this in part by doing a 
trial assembly to check your code, then SAVEing the 
Assembly language program on tape before trying to 
assemble it into its location addresses. This is similar 
to saving a BASIC program before trying to RUN it 
Details of how to save source files are given 
overleaf. 

lf your program executes successfully, then the 
<DEBUG> prompt and cursor will return to the 
screen. The ‘D’ command can now be used to display 
the contents of the memory which the program should 
affect. If the results are successful, then you might 
want to SAVE the machine code (called the Object 
Code to distinguish it from the Assembly language 
Source Code) to tape, using the ‘W command in 
<DEBUG>. Having done that, you might like to try 
altering some of the object code in memory using the 
‘@’ command, also in <DEBUG>. Once you've 
Started to understand roughly what’s going on in 
Champ, you should simply play around with any and 
every command or option that meets your eye — you 
can’t damage anything, and it’s really the only way to 
learn. 


